/*
 * Copyright (c) 1997, 1999, Oracle and/or its affiliates. All rights reserved.
 * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 */

package javax.swing.table;

import java.awt.Component;
import javax.swing.CellEditor;
import javax.swing.*;

/**
 * This interface defines the method any object that would like to be
 * an editor of values for components such as <code>JListBox</code>,
 * <code>JComboBox</code>, <code>JTree</code>, or <code>JTable</code>
 * needs to implement.
 *
 * @author Alan Chung
 */


public interface TableCellEditor extends CellEditor {

  /**
   * Sets an initial <code>value</code> for the editor.  This will cause
   * the editor to <code>stopEditing</code> and lose any partially
   * edited value if the editor is editing when this method is called. <p>
   *
   * Returns the component that should be added to the client's
   * <code>Component</code> hierarchy.  Once installed in the client's
   * hierarchy this component will then be able to draw and receive
   * user input.
   *
   * @param table the <code>JTable</code> that is asking the editor to edit; can be
   * <code>null</code>
   * @param value the value of the cell to be edited; it is up to the specific editor to interpret
   * and draw the value.  For example, if value is the string "true", it could be rendered as a
   * string or it could be rendered as a check box that is checked.  <code>null</code> is a valid
   * value
   * @param isSelected true if the cell is to be rendered with highlighting
   * @param row the row of the cell being edited
   * @param column the column of the cell being edited
   * @return the component for editing
   */
  Component getTableCellEditorComponent(JTable table, Object value,
      boolean isSelected,
      int row, int column);
}
